package com.strange.mdl.module.mdl.service.sutras;

import com.strange.mdl.framework.common.pojo.PageResult;
import com.strange.mdl.module.mdl.controller.admin.sutras.vo.chapters.MdlSutraChaptersPageReqVO;
import com.strange.mdl.module.mdl.controller.admin.sutras.vo.chapters.MdlSutraChaptersSaveReqVO;

import com.strange.mdl.module.mdl.controller.app.sutras.vo.AppMdlSutrasChapterRespVO;
import com.strange.mdl.module.mdl.dal.dataobject.sutras.MdlSutraChaptersDO;
import jakarta.validation.Valid;

import java.util.List;

/**
 * 经书章节 Service 接口
 *
 * @author 密谛灵总控
 */
public interface MdlSutraChaptersService {

    /**
     * 创建经书章节
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createSutraChapters(@Valid MdlSutraChaptersSaveReqVO createReqVO);

    /**
     * 更新经书章节
     *
     * @param updateReqVO 更新信息
     */
    void updateSutraChapters(@Valid MdlSutraChaptersSaveReqVO updateReqVO);

    /**
     * 删除经书章节
     *
     * @param id 编号
     */
    void deleteSutraChapters(Long id);

    /**
     * 批量删除经书章节
     *
     * @param ids 编号
     */
    void deleteSutraChaptersListByIds(List<Long> ids);

    /**
     * 获得经书章节
     *
     * @param id 编号
     * @return 经书章节
     */
    MdlSutraChaptersDO getSutraChapters(Long id);

    /**
     * 获得经书章节分页
     *
     * @param pageReqVO 分页查询
     * @return 经书章节分页
     */
    PageResult<MdlSutraChaptersDO> getSutraChaptersPage(MdlSutraChaptersPageReqVO pageReqVO);

    /**
     * 获得经书章节列表
     * @return 经书章节列表
     */
    List<MdlSutraChaptersDO> getSutrasChapterList(Long sutraId);

    /**
     * 获得经书章节内容
     * @param sutraId  经书ID
     * @param chapterId 章节ID
     * @return 经书章节内容
     */
    MdlSutraChaptersDO getSutrasChapterContent(Long sutraId, Long chapterId);
}
